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Preface 

This document provides supplemental information about the Version 4.2 
VMS Workstation Software. If you have not already done so, please read 
the Read Me First information included with your documentation. 

Intended Audience 


This manual is for graphics programmers and users who should know 
about new features, problems and restrictions, and changes to existing 
documentation. All users should read this document before using the VMS 
Workstation graphics software. 

Document Structure 


The VMS Workstation Software Release Notes , Version 4.2, is arranged in four 
chapters that cover the following topics: 


• Chapter 1—Summary of new and changed features 

• Chapter 2—Resolved problems 

• Chapter 3—Problems and restrictions 

• Chapter 4—Notes to published documentation 


Associated Documents 


The following manuals are related to this document: 

• VMS Workstation Software Installation Guide 

• UIS to DDIF Converter Installation and User's Guide 

• DECwindows/Xll Sewer for VWS Installation and User's Guide 

• A Guide to Migrating UIS Applications to DECwindows 

• VMS Workstation Software User's Guide 

• VMS Workstation Software Graphics Programming Guide 

• VMS Workstation Software Video Device Driver Manual 

• VMS Workstation Software Guide to Printing Graphics 

• VMS Workstation Software SIGHT User's Guide 

• Using the VMS Workstation Software Tektronix 4125® Emulator 


vii 










Preface 


Conventions 


Unless otherwise noted, the following conventions are used in this manual 
in displaying examples and the requirements of user input to the system. 


Convention 

Meaning 

|RETURN| 

This symbol indicates that you press the key 


marked | RETURN j. 

| CTRL/x | 

This symbol indicates that you must press the 
key labeled |CTRL| while you simultaneously press 
another key, for example, | CTRL/C], |CTRl/Y|, 

| CTRL/O |. 

Ellipsis 

Vertical series of periods, or ellipsis, mean either 
that not all the data that the system would display 
in response to the particular command is shown 
or that not all the data a user would enter is 
shown. 

file-spec, . . . 

Horizontal ellipsis indicates that additional 
parameters, values, or information can be 
entered. 

[Square brackets] 

Square brackets indicate that the enclosed item 
is optional. (Square brackets are not, however, 
optional in the syntax of a directory name in a 
file specification or in the syntax of a substring 
specification in an assignment statement.) 

Quotation marks 

The term quotation marks is used to refer 
to double quotation marks (”). The term 
apostrophe is used to refer to a single quotation 
mark ('). 

Italics 

Italicized words indicate that you should supply a 
value. 
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VMS Workstation Software Summary of New and 
Changed Features 


This chapter describes major changes and added features in VMS 
Workstation Software since Version 4.1. 


1.1 General Information for Version 4.2 


1 . 1.1 

C 


Prerequisite Software 

VWS Version 4.2 runs on VMS Version 5.0 or later. 

• To use the DECwindows/Xll server for VWS, you must install VMS 
Version 5.1 or 5.2. 

• To use the UIS to DDIF converter, you must install VMS Version 5.1 or 
later. 


NOTE: If you are running VMS Version 5.1, make sure that you have also 
installed DECwindows. 


1 . 1.2 



Licensing 

VMS Workstation Software Version 4.2 uses the VMS License Management 
Facility (LMF). To run VWS on a particular node, you must have a valid 
VWS license loaded. If the license is not properly loaded before you 
invoke the VWS startup procedure, an error message appears on the 
console and VWS terminates. If this occurs, load the VWS license and 
re-invoke the VWS startup procedure. 

Refer to the VMS LMF documentation for more information on the License 
Management Facility. 

NOTE: No license is required for the use of the VWS to DECwindows migration 
tools. 


1.2 Changes for Version 4.2 

1.2.1 Problem Resolutions 

VWS Version 4.2 includes a number of problem resolutions that 
change values returned or UIS behavior to correspond to published 
documentation. If you have applications that work around these problems, 
these problem resolutions might be incompatible and require further 
changes. Chapter 2 contains further information about Version 4.2 problem 
resolutions. 
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VMS Workstation Software Summary of New and Changed Features 


1.2.2 The Getting Started Window 

When no windows are on the screen, press any character, arrow, or keypad 
key to display the Getting Started window. 

The Getting Started window gives instructions for using the mouse. If you 
follow the instructions, a window containing the Workstation Options menu 
appears on the screen. 

If you press [HELP] while the screen is blank, the Getting Started window 
appears on the screen and provides information about using the 
VAXstation features. Figure 1-1 shows the Getting Started window for 
VWS Version 4.2: 

Figure 1-1 The Getting Started Window 


Getting Started 


VMS Workstation Software - VWS V4.2 

Press the HELP key 
or 

Use the mouse to move the pointer to 
a blank part of the screen and then 
click the leftmost mouse button. 

©1989 DIGITAL EQUIPMENT CORPORATION 
All Rights Reserved. 


1.3 New Features for Version 4.2 
1.3.1 UIS to DDIF Converter 

VWS Version 4.2 includes the UIS to DDIF converter. This software 
converts a UlS-encoded input file to an output file encoded in Digital 
Document Interchange Format (DDIF) or some specified output supported 
by the common document architecture (CDA) converter library. 

NOTE: For the purposes of installing the UIS to DDIF Converter, the name of the 
saveset is UISCNV010. 

See the lUS to DDIF Converter Installation and User's Guide for detailed 
information about installing and using this software. 
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VMS Workstation Software Summary of New and Changed Features 


1.3.2 Migrating UIS Applications to DECwindows 

VWS Version 4.2 provides information to enable you to migrate certain UIS 
applications to the DECwindows environment. This information includes 
software in the form of an example program that provides an example of a 
UIS application and its DECwindows counterpart. 

See A Guide to Migrating UIS Applications to DECwindows for details. 

Installing Example Program Savesets 

Example programs are included in A Guide to Migrating UIS Applications to 
DECwindows . 

• If you are installing from a TK50 tape cartridge, enter the following 
command to invoke the VMSINSTAL command procedure: 

$ @SYS$UPDATEsVMSINSTAL GUIDETOMO10 ddcu: 

where: 

ddcu: = tape unit name 

• If you are installing from diskette, locate the floppies labeled: 

VMS/WS GDTMIG V4.2 RX33 1/3 
VMS/WS GDTMIG V4.2 RX33 2/3 
VMS/WS GDTMIG V4.2 RX33 3/3 

Enter the following command to invoke the VMSINSTAL command 
procedure: 

@ SYS$UPDATE:VMSINSTAL GUIDETOMO10 ddcu: 

where: 

ddcu: = disk unit name 

You can find the example programs in SYS$EXAMPLES. The program 
images provided are called FREDIT.EXE and FREDITX11.EXE. 


1.3.3 DECwindows/XII Server for VWS 

This software provides current VWS users with an introduction to the 
DECwindows environment and enables non-production DECwindows 
development for users who continue to use VWS as their main windowing 
system. 

NOTE: For the purposes of installing the DECwindows/Xll Server for VWS, the 
name of the saveset is VWSDECW010. 

S^e the DECwindows/Xll Server for VWS Installation and User's Guide for more 
detailed information about installing and using this software. 


1-3 










2 


VMS Workstation Software Resolved Problems 


This chapter describes VMS Workstation Software problems that have been 
resolved for the VWS Version 4.2 release. 


2.1 Programming Interface 


2 . 1.1 

€ 


UISSCIRCLE and UIS$ELLIPSE—Overflow Problem 

Previous versions of VWS had a problem with filled, partial ellipses where 
the object could be drawn incorrectly during close zooms. This has been 
fixed so that all circles and ellipses are now drawn correctly. 



UIS$EXECUTE—INSFMEM Crash 

In the past, UIS continued to allocate memory during successive looping 
calls to UIS$EXECUTE, even though a UIS$DISABLE_DISPLAY_LIST call 
had set the display list UIS$M_DL_ENHANCE_LIST bit to zero. 

The problem occurred when UIS$EXECUTE was given a binary encoding 
stream that had a segment definition containing private data. This problem 
could cause an INSFMEM (insufficient memory) crash or a traceback. 

The following code example illustrates a situation that would cause this 
problem to occur: 

PROGRAM private 
IMPLICIT INTEGER(A-Z) 

INCLUDE 'SYS$LIBRARY:UISENTRY' 

INCLUDE 'SYS$LIBRARY:UISUSRDEF' 

CHARACTER*1000 BUFF 

VOID = UIS$CREATE_DISPLAY (0.0, 0.0, 10.0, 10.0, 10.0, 10.0) 

CALL UIS$BEGIN_SEGMENT(VDID) 

CALL UIS$PRIVATE (VDID, 42, 'HELLO') 

CALL UIS$END_SEGMENT(VDID) 

ROOTID = UIS$GET_ROOT — SEGMENT (VDID) 

CALL UIS$EXTRACT__OBJECT (ROOTID, 1000, %REF (BUFF) , BLEN) 

CALL UIS$DISABLE__DISPLAY_LIST (VDID) 

DO WHILE (1) 

CALL UIS$EXECUTE (VDID, BLEN, %REF(BUFF) ) 

ENDDO 

END 

This has now been corrected. 
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VMS Workstation Software Resolved Problems 


2.1.3 UIS$EXTRACT_OBJECT—Incorrect Length Returned 

In the past, when you used this call with just the obj_id and retlen 
arguments, improper object length could be returned. This has been 
corrected so that if any private data is associated with the object, its length 
is now included with the object length. 


2.1.4 UIS$EXTRACT_TRAILER—Bugcheck 

Now UIS$_BUF_FULL is signaled if the buffer passed into this routine 
is not large enough. Previously, if the buffer was not large enough, a 
bugcheck would occur. This resulted in process deletion. 


2.1.5 UIS$HLS__TO_RGB—Incorrect Return Value 

When you use this routine with decimal values L = .53 or L = .72, you 
now receive the correct results for R, G, and B values. 


2.1.6 UIS$MOVE_WINDOW—Repaint problem 

In the past, when you called UIS$MOVE_WINDOW, certain objects would 
appear bolded or would overwrite other objects that would not be replayed. 
This has now been corrected. 


2.1.7 UIS$PLOT—Exception Filling Polygons 

In certain special cases, an insufficient amount of memory was allocated 
for a fill polygon. This resulted in an access violation. This problem has 
been corrected. 


2.1.8 UIS$SOUND_CLICK—Incorrect volume used 

In the past, if you called UIS$SOUND_CLICK but omitted the keyclick 
volume argument, the system used the loudest click volume rather than the 
default volume. This has been corrected and the default volume is now 
used. 


2.1.9 UIS$TEXT—X Coordinate Problem 

The routine UIS$TEXT accepts a control list to control how string 
text is written to the display. In the past, the formatting command 
UIS$C_TEXT_NEW_LINE did not use the margin set with the 
UIS$SET_TEXT_MARGINS routine to set the X coordinate of the text 
output position. Rather, UIS$C_TEXT_NEW_LINE placed the text at X = 
0. This has now been corrected. 
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VMS Workstation Software Resolved Problems 


2.1.10 BAD_KB Signaled 

In the past, if you deleted an ICONized virtual keyboard, then expanded 
the icon, you would receive the following traceback: 

%UIS-F-BAD_KB f illegal virtual keyboard identifier 

This has been corrected. Now the message is not provided, and when the 
window is un-ICONized the keyboard icon does not appear in the banner. 


2.2 User Interface 

2.2.1 KRNLSTAKNV Crash 

VWS Version 4.2 corrects one instance of the KRNLSTAKNV crash. This 
crash tended to occur when viewports were POPped as the KB icon was 
being drawn in the upper right corner during creation of the window 
banner under a heavy system load. 


2.2.2 Viewport Delete Crash—INCONST ATE 

In the past, a crash could occur when you attempted to use the mouse to 
POP, PUSH, or pick up on a viewport while it was being deleted. This 
would occur during a heavy system load when the mouse button was 
depressed anywhere within the viewport region after you logged out, or 
during startup, before complete initialization. 

This has now been corrected. 


2.2.3 Missing Borders and Banner 

In the past, when a display list was reexecuted after a window was 
moved or redrawn, the borders and banner were missing or other screen 
corruption occurred. This is now corrected. 


2.3 HCUIS 

2.3.1 RENDER Command 

A problem existed with the /FRAME qualifier of the RENDER command 
when the destination was a PostScript printer. The RENDERed file now 
contains the proper encoding, and the printer will output the file as 
expected. 


2.3.2 HCUISSETUP 

A problem with downloading data files to the LCP01 or LCG01 printers has 
been corrected. The software now takes into account the device being set 
up and gets the data file from the appropriate directory, rather than looking 
only in the LCP01 directory. 
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VMS Workstation Software Resolved Problems 


2.4 SIGHT _ 

2.4.1 Grid Saved in SIGHT_DUMP.UIS 

When a crash occurs in SIGHT with the grid on, and a SIGHT_DUMP.UIS 
file is written, that dump file no longer includes the grid. 


2.5 VT200 Series Terminal Emulator 

2.5.1 DECRC Escape Sequence 

In the past, the receipt of the Restore Cursor escape sequence (DECRC) for 
an invalid saved cursor position would cause an exception that resulted in 
process deletion or system crash. This problem has been corrected. 


2.5.2 Enable Window Reports 

Previously, the escape sequences to enable the gain KB event reports and 
lose KB event reports were reversed. Thus, enabling the gain KB event 
report would actually enable the lose KB event report, and vice versa. The 
escape sequences for disabling the gain and lose KB event reports were 
similarly reversed. This problem has been corrected and now works as 
documented. 


2.5.3 Hang When Creating Process Exits 

If the process that created the terminal emulator structures (the first writer 
to the terminal) terminated while channels were still assigned from a 
second process, the window became orphaned and the system would hang 
and possibly crash later. This has been corrected in VWS Version 4.2 so 
that process deletion is blocked until the above channels are deassigned. 


2.5.4 Locator Non-Fatal Bugchecks 

In VWS Version 4.1, several of the terminal emulator mouse input modes 
could cause the emulator to handle state information improperly. This 
caused frequent non-fatal bugchecks, which would have lowered system 
performance and increased error-logging activity. It might also have caused 
the hold-screen function to fail. This has now been corrected. 


2.5.5 NRC Mode 

The VT200 series terminal emulator used to ignore establishment of NRC 
mode via the Workstation Options menu. (Invoking NRC mode via the 
Window Options menu or the DECNRCM escape sequence worked 
correctly.) This problem is now corrected. 
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VMS Workstation Software Resolved Problems 



2.5.6 ReGIS Report Macrograph Contents 

Previously, if you issued a ReGIS Report Macrograph Contents command 
for a macrograph that had not been previously defined, an access violation 
would occur. This resulted in window-deletion or a system crash. This 
problem has been resolved, and the emulator now returns the correct null 
macrograph. 


2.5.7 



2.6 


SYSGEN Parameter Modification 

In the past, VWS would modify SYSGEN parameter USER4. This has now 
been changed. VWS no longer uses or modifies this parameter. 


Device Driver Interface 


2.6.1 Incorrect Mouse Button Symbols in $QVBDEF Resolved 

Symbols for the mouse buttons used in the Enable Input Simulation QIO 
were defined in the incorrect order in $QVBDEF, which is defined in 
VWSSYSDEF. This has been corrected and the symbols are now defined 
properly. 



Old 

(Incorrect) 

Symbol Value New (Corrected) Value 


QV$M_BUTTON_1 

1 

4 

QV$M_BUTTON_2 

2 

2 

QV$M_BUTTON_3 

4 

1 

QV$M_BUTT ON_4 

Undefined 

8 


2.6.2 



PGFIPLHI Bugchecks 

In the past, a PGFIPLHI bugcheck and system crash could result when you 
used either the Modify Keyboard Characteristics (IO$C_QV_MODIFYKB) 
or the Get Keyboard Characteristics (IO$C_QV_GETKB_INFO) QIO 
functions. This has now been corrected. 
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VMS Workstation Software Problems and 
Restrictions 


This chapter describes problems and restrictions you might encounter 
when using VMS Workstation Software Version 4.2. 


3.1 Programming Interface 

The following sections describe problems and restrictions in the 
programming interface. 


3.1.1 UIS$IMAGE Hang—Workaround 

Sometimes during reexecution of the display list (most often when you are 
using images), your process might reach a point where it becomes stalled 
or the process hangs. 

To work around this problem, issue a call to UIS$MOVE_WINDOW 
immediately after you have created the window, using the same world 
coordinates that you used in the create window call. 

If you resolve a problem by using this workaround, please report your 
problem and solution via the SPR process. 


3.1.2 UIS$C_TEXT_WRITE—16-Bit Text Problem 

When you use text with control lists and 16-bit text (for example, 2-byte 
Kanji fonts), the control list item UIS$C_TEXT_WRITE should have a 
value that specifies the number of characters it will write. VWS interprets 
this value as the number of bytes VWS will write instead. To avoid this 
problem when you use 16-bit text, specify double the number of characters 
you want to write as a value for the control list item. 


3.1.3 UIS$DISABLE_KB and UIS$DISABLE_VIEWPORT_KB—AST Not 
Delivered 


When a virtual keyboard is disabled by a UIS$DISABLE_KB or 
UIS$DISABLE_VIEWPORT_KB, the Lose Keyboard AST routine will not be 
delivered. If your application depends on this AST being received after the 
virtual keyboard has been detached from the physical keyboard, you must 
explicitly call the AST routine after disabling the keyboard. 
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VMS Workstation Software Problems and Restrictions 


3.1.4 UIS$SETJ<B_ATTRIBUTES—Spurious Data 

When you are using the Up/Down key transitions enabled by 
UIS$SET_KB_ATTRIBUTES, you might get spurious data when the physical 
keyboard is attached to the window. A possible solution is to ignore 
incoming data for a short time after getting a GAIN_KB_AST. This will be 
fixed in a future release. 


3.1.5 UIS$SET_POINTER_AST—Out-of-Order Execution of Exit AST 

Routines 

When two contiguous regions have been set up with 
UIS$SET_POINTER_AST, you might execute an exit AST intended for 
the previous region after executing the first movement AST routine for the 
new region. 

To clarify, when you exit from one region and enter the other, three actions 
occur in the following order: 

1 The last movement in the first region 

2 Exiting from the first region 

3 The first movement in the new region 

However, the ASTs associated with these actions might be delivered out of 
order: last movement, first movement, exit. 

The recommended solution is to test for the first movement on any 
contiguous region and emulate the exit AST before taking any other 
action. According to the application, you might want to emulate only 
some essential portion of the exit AST routine and let the actual AST 
perform the remainder when it is executed. 


3.1.6 Drawing Problems 

3.1.6.1 Images That Use Eight Bits per Pixel 

When you draw images that use eight bits per pixel, use the COPY writing 
mode (UIS$C_MODE_COPY) to use the pixel values as direct indexes into 
the color map. This writing mode copies each pixel value from the image 
into the bit map without any changes to the data. 

The default writing mode (UIS$C_MODE_OVER) does not function like 
COPY mode. 


3.1.6.2 Fill Patterns and Clipping Regions Anomaly 

When you are drawing, using a fill pattern with a clipping region in effect, 
the pattern is aligned with the lower-left corner of the clipping region rather 
than the lower-left corner of the window. This might cause undesirable 
visual effects if you did not intend to have the pattern "flow" across this 
boundary. 
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3.1.7 VWSSYSDEF.H—Contains Syntax Errors 

If you select the C language option in the installation procedure, the 
resulting VWSSYSDEF.H file contains syntax errors. These syntax errors 
cause compiler warnings when you include the VWSSYSDEF.H file in your 
program. 

To avoid these compiler warnings, edit the file to remove the dimension 
specification ("[1]") from the declarations of the following structures: 

dop_point_array 

dop_line_array 

dop_ftext_array 

dop_ftext_array 

dop_poly_array 

dop_image_array 

dop_move_array 

dop_move_r_array 

dop_mvr_array 


3.1.8 SYS$SUSPEND Calls—Can Cause Workstation Hangs 

Calling the SYS$SUSPEND system service to suspend a workstation 
process that creates windows can cause your workstation to hang. That is, 
no further display operations are executed. 

The locks control the process access to the workstation display. When 
you use the SYS$SUSPEND system service call to suspend a process that 
currently holds a lock, the process cannot give up its display lock; thus, it 
prevents other processes from accessing the display. 

To return your workstation to normal operation, issue a SYS$RESUME 
system service call, specifying the suspended process. 


3.1.9 Hardware Replay to a Previously Occluded Area of the VAXstation 
ll/GPX Display—Causes Undesirable Visual Effects 

On a VAXstation II/GPX, the VMS Workstation Software uses two methods 
to restore occluded windows that have become exposed. Its first method 
is to specify that the GPX hardware "replay" the list of commands that 
generated the graphics in the occluded area. When the list of commands 
gets too long, the VMS Workstation Software switches to its second 
method, which saves the screen contents in the occluded area and copies 
them to the display when the occluded area is exposed. 

In some applications, the first replay method causes undesirable visual 
effects. To avoid these undesirable visual effects, execute a scrolling 
operation within the viewport. The scrolling operation causes the VMS 
Workstation Software to switch from the replay method to saving the 
screen contents in the occluded area. 
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To execute a scrolling operation in the viewport, you can either make a call 
to UIS$MOVE_WINDOW or, if you are using the DOP interface, queue a 
SCROLL_AREA DOP. You should specify the same world coordinates in 
the move window call that you specified when you created the window. 

The following FORTRAN code segment demonstrates how to disable 
hardware replay for a window: 

WD_ID = UIS$CREATE_WINDOW(VD_ID,0. f 0.,1.,1.,20.,20.) ICreate window 
CALL UIS$MOVE_WINDOW(VD_ID,WD_ID,0.,0.,1.,1.) !Disable replay 


3.1.10 Specifying a Negative Value As Start_deg or End_deg—Causes 
Incorrect Drawing of a Circle or Ellipse 

If you specify a negative value as the start_deg or End_deg parameter for 
a circle or ellipse, it is drawn incorrectly. To achieve the desired drawing 
results when specifying a negative value for either of these parameters, do 
the following: 

1 Take the negative value modulo 360 and add 360. 

2 Specify the resulting value as the start_deg or End_deg parameter. 

The following FORTRAN code segment demonstrates how to change a 
negative value into a value that causes the system to execute the drawing 
operation correctly: 

START_DEG = AMOD(START_DEG,360.)+360. 

END_DEG = AMOD(END_DEG,360.)+360. 

CALL UIS$CIRCLE(VD_ID f ATB,X,Y ,RADIUS,START_DEG,END_DEG) 


3.1.11 Text Problems 

The following sections describe problems and restrictions that can occur 
when you use text with the programming interface. 

3.1.11.1 Extracting Transformed Control Lists 

The result of extracting transformed control list text is undefined. That is, 
the following sequence of routine calls will produce a buffer containing 
unpredictable results: 

UIS$TEXT(vd_id, atb, text_string, x, y, ctllist, ctllen) 
obj_id = UIS$GET_CURRENT_OBJECT(vd_id) 

UIS$TRANSFORM_OBJECT(obj_id, matrix, atb) 

UIS$EXTRACT_OBJECT(obj_id, buflen, bufaddr, retlen) 

NOTE: The results on the screen and within the UIS internal display list are 
correct. 
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3.1.11.2 Tabs in Control Lists 

Text that has a control list containing relative or absolute tabs might 
produce unexpected results if the text falls under any of the following 
categories: 

• Sloped 

• Written with a non-default major text path (for example, 
UIS$C_TEXT_PATH_LEFT) 

• Transformed (using UIS$TRANSFORM_OBJECT or 
UIS$COPY_OBJECT) to be sloped 

Slanted text that has a control list containing relative or absolute tabs might 
erase portions of characters when written with any writing mode that writes 
the background, such as overlay negate. 

3.1.11.3 Text Placement and Display Lists 

After calling UIS$TEXT and UIS$NEW_TEXT_LINE to create lines of text, 
you might want to insert more text at the end of a line. Since text position 
is undefined when you insert text into a display list, you should always 
explicitly position your inserted text. 


3.1.11.4 Enabling and Disabling Text Formatting 

If the original input attribute block for a UIS$TEXT or UISDC$TEXT call 
with a control list does not have text formatting enabled and a subsequent 
ATB in the control list does format text, the results are undefined. 


3.1.11.5 Formatted Text with Non-Default Attributes 

Formatted text gives undefined results if the text or vertical major text 
path being written has non-default attributes of slant, slope, rotation, or 
character size. The same is true for formatted text that is transformed to 
have non-default attributes of slant, slope, rotation, or character size. 


3.1.11.6 Full Text Justification of Nonstandard Fonts 

For fully justified text to work correctly with fonts other than those supplied 
on the distribution kit, the glyph for the space character must be in the 
33rd position in the font, which is the same position as the ASCII space 
character in the supplied fonts. 


3.1.11.7 Text Slope Angles with Distorted Windows 

If you use UIS$TEXT to display sloped text and the window/viewport 
mapping is distorted (that is, the aspect ratio of the window differs from 
the aspect ratio of the viewport), the results differ. This depends on 
whether character scaling is enabled. If character scaling is not enabled, 
the angle is displayed relative to the device. For example, at a slope of 45 
degrees (with major path right), each character position moves up and right 
by the same number of pixels. If character scaling is enabled, the slope 
is measured relative to world coordinates. For example, at a slope of 45 
degrees (with major path right), each character position moves up and right 
by the same world-coordinate amount. 


3-5 











VMS Workstation Software Problems and Restrictions 


If sloped text is displayed using UISDC$TEXT, the slope angles are 
measured based on device coordinates, regardless of whether scaling is 
enabled. 

This behavior is permanent and is consistent with other uses of unsealed 
text and UISDC routines with distorted viewport/window mappings. 


3.1.11.8 Text Slope Angles on VR100 Monitors 

If sloped text is displayed using UIS$TEXT with character scaling disabled, 
the angles appear to be distorted, even if the viewport and window aspect 
ratios are the same. The reason for this behavior is that the angle is being 
drawn in device coordinates, and pixels on a VR100 are not square. To 
make the angle appear correct, you must enable character scaling, using 
the UIS$SET_CHAR_SIZE routine. 

If sloped text is displayed using UISDC$TEXT, angles appear distorted on 
a VR100 monitor. 

This behavior is permanent and is consistent with other uses of unsealed 
text and UISDC routines with VR100 monitors. 

Note: The only supported hardware device that uses a VR100 monitor is a 
VAXstation I. 


3.1.11.9 Scaled Text—GPX and VAXstation 2000 Systems 

When the VAXstation II/GPX or color VAXstation 2000 scales text, 
distortion can occur as a result of the hardware's inability to scale properly 
to non-integer values. If you are using a writing mode that changes 
background pixels (for example, REPL or REPLN), the foreground pixels 
can be overwritten. This can result in what appears to be missing pixels in 
scaled characters. This problem occurs more often with proportionally 
spaced fonts than with monospaced fonts. If text is drawn at slope, 
rotation, or slant angles that are not zero or multiples of 90 degrees, 
scaling is done implicitly. 

This is a permanent restriction. 


3.1.11.10 Scaled Text—All Systems 

If text is written in a mode that causes the background of the cell to 
be written (for example, REPL or REPLN), unwritten pixels might exist 
between adjacent character cells. If text is drawn at slope, rotation, or slant 
angles that are not zero or multiples of 90, scaling is done implicitly. 

This is probably an unavoidable effect of rasterization, but investigation of 
possible future improvements continues. 


3.2 User Interface 

The following sections describe problems and restrictions in the user 
interface. 
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.2.1 


VAXstation ll/GPX Boot Problem 

If your VAXstation II/GPX system is unresponsive during a boot or 
shutdown operation, press the F2 key. The system might have written 
a message to the operator console window and might be waiting for you to 
read the message before it continues. The operator console window stays 
activated only for 30 seconds. This restriction prevents the possibility of 
hanging your workstation. 


3.2.2 



Restriction with Autologin 

If you log in to your first terminal emulator window while autologin 
is enabled and then quickly create another window, you might not be 
automatically logged in to the second window. This is because the process 
information for the first window has not yet been saved. A solution is to 
wait until the initial login procedure has executed before creating additional 
terminal emulator windows. 


3.2.3 



Print Destination Restriction 

The "Enter new print destination" option of the Printer Setup menu 
no longer exists. See VMS Workstation Software User's Guide , Chapter 2, 
"Changing Print Destination" for a detailed explanation of this restriction. 


3.2.4 RESIZE WINDOW Time-Out Implemented 

The RESIZE WINDOW feature has been modified so that it stays activated 
for 30 seconds. This restriction prevents the possibility of hanging your 
workstation. 


3.2.5 



SET PROCESS/SUSPEND Command Can Cause Your Workstation 
to Hang 

Entering the SET PROCESS/SUSPEND command to suspend a workstation 
process that creates windows can cause your workstation to hang. That is, 
no further display operations are executed. 

Locks control the process access to the workstation display. When you 
use the SET PROCESS/SUSPEND command to suspend a process that 
currently holds a lock, the process cannot give up its display lock; thus it 
prevents other processes from accessing the display. 

To return your workstation to normal operation, enter the SET 
PROCESS/RESUME command, specifying the suspended process. 
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3.3 SIGHT 

3.3.1 SIGHT Now a DCL Command 

If you have previously defined a symbol for SIGHT in your login command 
procedure or in SYS$SYLOGIN, remove it. Failure to do so will produce 
the following error message: 

%CLI-F-SYNTAX error parsing 'filespec' 

when you invoke SIGHT via the DCL command SIGHT. 


3.3.2 Monitor Size Restriction 

Currently, if you edit a SIGHT drawing on a monitor that is different in 
size from the one on which you created the drawing (for example, a 19-inch 
monitor for creation and a 15-inch monitor for editing), the drawing will be 
improperly scaled. For proper visual effect, edit your SIGHT drawing on a 
system with the same size monitor as the one on which you created it. 


3.4 VT200 Series Terminal Emulator 

3.4.1 NRC Mode 

The VT200 series terminal emulator currently supports National 
Replacement Character set (NRC) mode only for output. Special characters 
cannot be mapped to their NRC 7-bit codes on input. You should use the 
Multinational Character Set (MCS) whenever possible. 


3.4.2 ReGIS Restrictions 

The terminal emulator implementation of ReGIS includes several 
restrictions. See VMS Workstation Software User's Guide, Appendix B, 
"ReGIS Implementation" for a full description of ReGIS restrictions. 


3.4.3 Window Hang with Outstanding Channels Assigned 

Process deletion is blocked if a second process has channels assigned to 
the terminal for which the first process is holding the terminal emulator 
data structures. 1 This second process could be a subprocess or a process 
with elevated privileges. This prevents the data structures from being 
deleted while they are still needed. 

This might appear as a VT200 series terminal emulator window that 
remains on the screen after you log out. Once the process or subprocess 
deassigns its channels, process-deletion is no longer blocked and the 
window disappears. 


1 In the absence of the VWS$EMULATORS process, the terminal emulator data structures are normally created in the 
process context of the first writer to the terminal. 
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3.5 Device Driver Interface 

3.5.1 MOVE/ROTATE DOP—Specifying Scaling 

There is a problem in specifying scaling in the MOVE/ROTATE Drawing 
Operation Primitive (DOP). 

If the source_width divided by the vecljength or the source_height divided 
by the vec2_length cannot be represented exactly in 12 bits or fewer, a pixel 
might be dropped from the end of the source. 

The recommended solution is to decrease the vector length (usually by a 
constant 1 or 2 pixels), without changing the Dx or Dy values, until the full 
source is drawn correctly. 


3.5.2 Using DOPs with UISDC$SET_CLIP 

When you use DOPs and the routine UISDC$SET_CLIP, the DOP returned 
from the routine UISDC$ALLOCATE_DOP contains incorrect values for 
the viewport clipping rectangle. 

The recommended workaround for this problem is to change the values 
within the DOP immediately after it is allocated, as shown in the following 
example. 

dop = uisdc$allocate__dop (&wdid, &dop_size, &1); 

dop->dop$w_vp_min_x = dop->dop$r_fill_9.dop$r_fill_10.dop$w_delta_x - 6; 
dop->dop$w_vp_min_y = dop->dop$r__f ill_9 . dop$r_f ill_10. dop$w_delta_y - 6; 

dop->dop$r_fill_9.dop$r_fill_10.dop$w_vp_max_x += dop->dop$w_vp_min_x; 
dop->dop$r_fill_9.dop$r_fill_10.dop$w_vp_max_y += dop->dop$w_vp_min_y; 


3.6 System Management 

3.6.1 Disabling Operator Messages to the Operator Window—OPAO 

For many applications, the appearance of operator (OPCOM) messages in 
the operator window is both unnecessary and annoying. To disable the 
output of OPCOM messages to the operator window, type the following 
commands from a suitably privileged account: 

$ DEFINE/USER SYS$COMMAND OPAO: 

$ REPLY/DISABLE 

To avoid duplicating effort, you can include the above commands in your 
SYSTARTUP_V5.COM file. 

NOTE: Remember that if you choose to eliminate operator messages, you risk 
missing important messages on the status and/or security of your system. 
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3.6.2 Receiving Operator Messages in a Local Area VAXcluster 

When your workstation is a member of a Local Area VAXcluster, its 
operator window is disabled by default. DIGITAL recommends that you do 
not reenable the operator window. Instead, to monitor operator messages, 
create a terminal emulator window and enter the REPLY/ENABLE 
command at the DCL prompt ($). To execute the REPLY/ENABLE 
command, you must have the OPER privilege. 


3.6.3 AUTOGEN Problem 

If you are running 100 DPI fonts, AUTOGEN incorrectly handles the setting 
of the TTY_DIALTYPE parameter for VWS V4.2. 

To work around this problem, add the following entry in 
SYS$SYSTEM:MODP ARAMS.DAT: 

TTY_DIALTYPE = 160 or TTY_DIALTYPE = 32 

depending on your hardware configuration. 


3.6.4 Fonts Loaded By Default and Slow Painting of Popped Windows 

Several factors can cause popped windows to paint slowly on GPX and 
color VAXstation 2000 systems. The following situations contribute to this 
problem: 

• Having a large number of fonts loaded. 

• Having a large number of windows (and/or large-sized windows) on the 
screen. 

To ease this problem, evaluate which fonts you load at system startup. 

By default, VMS Workstation Software starts up with only the necessary 
fonts. If you want alternate fonts, rename the files in SYS$FONT from 
UIS$LOAD_FONT*.TEMPLATE to UIS$LOAD_FONT*.COM. 

NOTE: Rename only the files that contain fonts you want to use. 

The command files in SYS$FONT called UIS$LOAD_FONT*.COM are 
executed at startup. You can rename a .COM file to .TEMPLATE to prevent 
the font from being loaded. Conversely, when you want to enable the font 
for loading, rename the .TEMPLATE to .COM. 

NOTE: The technical character set fonts are loaded as supplied 
(UIS$LOAD_FONT_TCS*.COM). 

In addition, the Technical Character Set fonts are loaded 
by default. If you do not normally use these fonts, rename 
the UIS$LOAD_FONT_TCS*.COM files in SYS$FONT to 
UIS$LOAD_FONT_TCS*.TEMPLATE. 

A complete list of fonts included with the VMS Workstation Software kit 
is provided in the VMS Workstation Software Installation Guide, Appendix A. 
Check that list to make sure you are not overburdening your system with 
unneeded fonts. Delete any unnecessary fonts from your system. 
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3.6.5 Color VAXstations in a Cluster Environment 

When you boot a VAXstation II/GPX with an alternate console terminal in 
a cluster environment, the hardware initialization might take so long that 
the cluster connection is lost. To prevent this occurrence, increase the 
SYSGEN parameter RECNXINTERVAL to 40 seconds on all nodes in the 
cluster. 


3.6.6 



Setting of MULTIPROCESSING SYSGEN Parameter 

VWS does not support multiprocessing synchronization. The SYSGEN 
parameter MULTIPROCESSING should not be set to two. (The default 
value is three.) 


3.6.7 




SYSTEM Account Must Be Usable to Load the VMS Workstation 
Software Correctly 

If the SYSTEM account is not usable, the VMS Workstation Software does 
not load correctly when you reboot the VAXstation hardware. Loading 
fails when the password for the SYSTEM account is expired. To update 
the password for the SYSTEM account, invoke the VMS Authorize Utility 
(AUTHORIZE). 

NOTE: This is a VMS rather than a VWS restriction. 
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Notes to Published Documentation 


This chapter contains additions or corrections to documentation that is 
not going to be updated for this release of VWS. Please make note of the 
additions/corrections. They will be added to the appropriate manuals in a 
later version of VWS. 


VWS Graphics Programming Guide— AA-GIIOC-TE 

UIS$SET_KB_ATTRIBUTES—Page 18-267 

Add the following symbols to the symbol description table: 


Symbol 

Description 

UIS$M_KB_UDMAIN 

Enable/Disable up button transitions for the main 
keyboard key. 

UIS$M_KB_UDCOMPOSE 

Enable/Disable up button transitions for the 
compose key. 


VWS Video Device Driver Manual— AA-DY65E-TE, AD-DY65E-T1 

Modify Keyboard Characteristics—Page 3-50 

Add the following symbols to the field use table: 


Characteristic 

Default 

Meaning 

QV$M_KEY_UDMAIN 

Off 

Main keyboard keys generate up/down 
transitions. 

QV$M_KEY_UDCOMPOSE 

Off 

Compose key generates up/down 
transitions. 
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